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1 Introduction 


This document describes the RS232 protocol for communication between customer applications and 
SW6000 Conference Management Software by use of the ECA External Control Application. 


Customer applications can include but are not limited to AMX or Crestron room control systems, PC’s or 
micro controller based applications e.g. for button mimics. 


The RS232 protocol is an easy to use protocol. 
For installation of the ECA application, please refer to the ‘Installation Manual SW6000’. 


1.1 Licensing 


The ECA application is included in the SW6000 Conference Management Software (basic) and no separate 
license is needed. 
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2 Configuring the ECA 


Description 


Start the ECA by selecting the ECA shortcut on the 
desktop 


A message is shown, that the ECA configuration is 
not found. 


Select ‘OK’ 


Select the Configure COM port 


Insert the correct parameters for the ECA 
application: 


Select COM port from 1 to 8 that will be used 


The COM ports, which are configured, will be 
highlighted. 


Insert the Name of the Computer, where the 
database is installed 


Insert the ‘Default Database name’ 


Insert the COM Port parameters. Set Baud Rate to 
fit with connected equipment. Handshake is not 
used with ECA communication. 


Comment or picture 


No configuration found for COM1. 
è ) Please configure the COM port in the configuration window. 


Database Connection 
© MS SQL eres 
Name d comata whare Oye dat abe n 
Detak ogada nerce name 
Defot database name 
Datat aeae tmas 
Database Uver 
Database User Password: 
COM Port 
Baud Rae 
Paty 
Data Be 


2p it 


Please make a setting for the ECA port 


Select ‘Test’. 


Note: If the test fails, change the setting which 
failed. If the saved configuration connects to 
another Com port than selected during installation, 
the command line parameter for the ECA short 
must be changed to the configured port. Please 
refer to next point. 


Select ‘Save’ 
Select ‘Exit’ 


(QA Database connection: 
Ok 


COM port: 
Failed - COM port is not available 


ee! 
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Description 


If the Com port must be changed in the ECA short 
cut 


Right-click the ECA shortcut 

Select Properties 

Select the ‘Shortcut’ tab 

Change COM port number in the ‘Target’ line 
Select ‘Apply’ 

Select ‘OK’ 


Comment or picture 


External Control Application COM2 Properties S) 


General| Shortcut | Compatibility | Security 


FCA External Control Application COM2 


Target type: = Application 


Target location: External Control Application 


Target: i\External Control ApplicationprE C4. exe" 


Start in: "C:\Program Files\DIS External Control Applicatio 


Shortcut key: | None 


Bun: Normal window 


Comment: 


Eind Target... Change Icon... Advanced... 


Start the ECA by selecting the ECA shortcut on the 
desktop 


A message is shown, that the ECA configuration is 
not found. 


Select OK 


Select the Configure COM port 


Insert the correct parameters for the ECA 
application: 


Select COM port from 1 to 8 that will be used 


The COM ports, which are configured, will be 
highlighted. 


Insert the Name of the Computer, where the 
database is installed 


Insert the ‘Default Database name’ 


Insert the COM Port parameters. Set Baud Rate to 
fit with connected equipment. Handshake is not 
used with ECA communication. 


No configuration found for COM1. 
Á? Please configure the COM port in the configuration window. 


Name cf computer whare tre database is wrt 
Defa database naince name 

Defa database name 

Detat catrbase tment 

Database User 


Database User Password 


Please make a setting for the ECA port 
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# | Description Comment or picture 
9. | Select ‘Test’. Connection 

Note: If the test fails, change the setting which failed. eve 

If the saved configuration connects to another Com port ss sik 


Failed - COM port is not available 


than selected during installation, the command line 
parameter for the ECA short must be changed to the 
configured port. Please refer to next point. 


Select ‘Save’ 


Select ‘Exit’ 

10.| If the Com port must be changed in the ECA short cut External Control Application COM2 Properties _[" |[] 
Right select the ECA shortcut General| Shortcut | Compatibility | Security 
Select Properties Extemal Control Application COM2 


Select the ‘Shortcut’ tab 
Change COM port number in the ‘Target’ line 


Target type: Application 


Target location: External Control Application 


Select ‘Apply’ Target: i\Extemal Control Application\pri€ CA. exe" ENB 
Select ‘OK’ : 
Start in: "C:\Program Files\DIS\Extemal Control Applicatio 
Shortcut key: [None 
Run: Normal window 
Comment 
2.1 Command line parameters for the ECA 
-W Show a communication window (debug) when the ECA is started. Don’t use this 
parameter in normal use. 
-COMx Specifies the COM port to use. COM1 to COM8 are valid entries. When the COM port 


is specified, the ‘Select COM port’ popup is disabled. 


- STARTUPDELAYx Specifies a delay that the application will wait before initializing completely. The 
delay x, is given in milliseconds. This is useful if the ECA shortcut is placed in the 
Start-up folder in windows, giving windows time to start services related to SQL, 
before the ECA starts communicating with the SQL server 


- DELAY Please refer to the section 'RS 232 Commands’ for details . 
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3 


Starting the ECA 


Comment or picture 


# | Description 
1. | Select the ECA shortcut to start the application gcal 


2. 


When started an ECA icon is shown in the task bar. 


If debugging is needed right select on the ECA icon 
and select display 


E] 


Display... 


About... 


Exit 
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A RS 232 Commands 


4] ‘Delay’ command line parameter 


As it has been experienced that external RS232 parsers can have difficulties in handling commands sent 
in quick succession it’s possible to introduce a minimum “dead-time” between commands from the ECA. 


To introduce this delay use the following command line parameter on the ECA application ‘-DELAYx’ 
where x has to be a number specifying the delay in milliseconds. 


This delay must be an integer greater than 0 and smaller than 2000 - corresponding to 2 seconds. 


Important: Introducing this delay has a severe impact on the number of messages that can be 
transmitted over the RS232 interface - so it should preferably be avoided. 


4.2 Commands from ECA to external RS232 device 

The commands sent from the ECA to an external RS232 device are described here. The commands are all 
ASCII commands - the commands should be possible to send and receive from any terminal e.g. 
HyperTerminal. Only printable characters are used so it’s possible to use any terminal program to key in 
commands and see the response. This approach has been used to facilitate testing and development by 
customers. 


<Seat no> 1-5 ASCII bytes with the seat number - this is equivalent to the content in the seat table 
for identifying the microphone e.g. “50001” or “123” 


<CHKSUM> 2 ASCII characters representing the hexadecimal checksum calculated over the command 
and seat no. 


The checksum shall be calculated as shown in this example with the command 
“1$1234:1D": 


‘S'=83 (ASCII value) 
‘1’=49 (ASCII value) 
‘2'=50 (ASCII value) 
‘3’=51 (ASCII value) 
‘4’=52 (ASCII value) 
The sum is calculated: 
sum= 83+49+50+514+52=285 
Modulus is calculated: 
285 mod 256 = 29 
Hex values is calculated: 
29 = 1D 
The two characters are used in the command as the checksum. 
<CR> Carriage return - OD = 13 


Command direction is identified using arrows - from ECA to EXT and from EXT to ECA, as well as both 
ways. 


j Microphone On (ECA €> EXT) 
IS<Seat no>:<CHKSUM><CR> 


Sent when microphone is switched on. 
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4.2.2 Microphone in speak (ECA <> EXT) 
Is<Seat no>: <CHKSUM><CR> 
Sent as a response to a microphone status request message to indicate that the microphone is in speak. 


4.2.3 Microphone Off (ECA €> EXT) 
!0<Seat no>:<CHKSUM><CR> 


Sent when microphone in speak is switched off. 


4.2.4 Request On (ECA €> EXT) 
IR<Seat no>: <CHKSUM><CR> 


Sent when microphone is set into request. 


4.2.5 Microphone in request (ECA > EXT) 
Ir<Seat no>: <CHKSUM><CR> 
Sent as a response to a microphone status request message to indicate that the microphone is in request. 


4.2.6 Request Off (ECA <-> EXT) 
IN<Seat no>:<CHKSUM><CR> 


Sent when microphone is switched off from request. 


4.2.7 Max Total Speakers (ECA €> EXT) 
'T<max spk>: <CHKSUM><CR> 
Maximum number of speakers allowed to speak. 


<max spk> Can be set to “1” to “8” 


42.8 Max Delegate Speakers (ECA <> EXT) 
IK<max spk>: <CHKSUM><CR> 
Maximum number of delegates allowed to speak. 


<max spk> Can be set to “1” to “8” 


4.2.9 Max Requests (ECA <-> EXT) 
!Q<max req>: <CHKSUM><CR> 


Maximum number of delegates allowed in the request list. <max req> Can be set to “0” to “255”. 


4.2.10 System Operation Mode (ECA <> EXT) 
!E<mode>: <CHKSUM><CR> 


System operation mode possible values are: “AUTO”, “FIFO”, “MANU”, “VOX”, “AUTO-REP”, “MANU-REP” 
and “VOX-REP”. 


4.2.11 System Interruptability (ECA <-> EXT) 
!|<mode>: <CHKSUM><CR> 
System operation mode possible values are: “NONE”, “LOWER”, and “SAMELOWER” 


4.2.12 Speaking Too Fast (ECA €> EXT) 
IP<state>: <CHKSUM><CR> 
Speaking too fast indicates that speakers should slow down to enable interpreters to keep up. 


<state> may be “0” or “1”, where “1” indicates that currently the speaking too fast condition is active. 
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4.2.13 Voting Start/Stop (ECA <-> EXT) 
!V<start-stop>: <CHKSUM><CR> 


Command is used for starting and stopping a voting session, as well as indicating whether a voting 
session is running. 


<start-stop> may be "0" or "1", where "0" indicates the voting session is stopped and "1" indicates the 
voting session is started (or running). 


The type of voting session, when started from ECA, is the default one. 


1.2.14 Status done (ECA > EXT) 
!D<CR> 


Sent to indicate that complete status of the microphone system has been transmitted. 


12.15 All microphones off (ECA > EXT) 
IF<CR> 


Sent to indicate that the number of microphones “On” is zero. This command is only sent when the last 
microphone is switched off. 


Observe that sending this command is not enabled as default - to enable this command use the command 
line parameter “-ALLMI COFF” on the CUI application. 


4.2.16 All replies off (ECA > EXT) 
!ALLREPLYOFF<CR> 
Sent when the ‘All Reply Off’ button is activated in the CUA. 


Observe that the command is send when a conference is started or stopped. 


12.17 User Validation request (ECA > EXT) 
!U<User id>S<Seat id>: <CHKSUM><CR> 


Sent to request external validation of user identified by <User id> using external validation equipment 
e.g. fingerprint reader identified by <Seat id>. 


4.2.18 Alert Status change (ECA > EXT) 
'A<status>: <CHKSUM><CR> 
Send when an alert is issued or cancelled. 


<status> may be “O” or “1”, where “1” indicates the alert is active. 


12.19 Speech Time Alarm (ECA > EXT) 

IL<status>S<Seat no>: <CHKSUM><CR> 

Sent to external units to indicate current status of speech time for the speaker seat (podiums). 
<status> may be one of the following values: 


e “0” - no alarm or expiration; issued only after another value was indicated in a previous “!L” for this 
seat, and then the microphone was switched off. It arrives before the corresponding “!O” notification. 

e “1” - alarm (if there was one set, otherwise this value is skipped). 

e “2” - time expired. 


When a microphone is closed, alarm state is always reverted to value 0. 


Note - this command is only sent for seats of Podium types. 
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43 Commands from external RS232 to ECA 


The commands issued to control microphones are identical to the commands that relay status from the 
ECA. E.g. to set microphone seat no 7 on the command “!S7:8A<CR>” is issued - the same command will 
return from the ECA to reflect that the microphone has actually been switched on. 


3.1 Request System Status (ECA € EXT) 
?D<CR> 


Sending this command will cause the ECA to transmit the current status of the system as a series of 
commands for max speakers, max total speakers, max requests, operation mode and a series of 
microphone in speak and microphone in request commands. When the ECA has transmitted all pending 
status information the Status done command is received. 


Observe that activity during a status request may cause e.g. speak on commands to be transmitted 
before all microphones in speak commands have been issued - this should not cause problems as the two 
commands use a different syntax. 


13.2 User Validation response (ECA € EXT) 
!U<User id>S<Seat id>R”<Validation response>": <CHKSUM><CR> 


This command should only be sent as response to a user validation request. <User id> and <Seat id> 
should be identical to what was included in the user validation request. <Validation response> should 
have one of the following values: 


e “Verified” - used when external verification equipment is able to verify the presence of the user at 
the specified seat 

e “Failed” - used when external verification equipment evaluates user and evaluation is negative - 
e.g. wrong fingerprint. 

e “Seat unknown” - used when external verification equipment has no entries for this seat. 

e “User unknown” - used when external verification equipment has no entries for this user. 

e External validation system may use other string up to 25 characters long to describe other error 
situations - string must not include character <“>. 
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5 Get familiar with the RS232 commands to/from 
ECA 


This section describes how to test the ECA commands using a second PC and Microsoft Terminal program. 


# | Description Comment or picture 


1 | Connect the PC with the ECA installation to a 
second PC with a null-modem cable. 


2 | Start the Microsoft Terminal program on 
both PCs from Start/Programs/Accessories/ 
Communications/ HyperTerminal. 


3  |Enter a name and choose an icon for the s- New Connection.: HyperTerminal -ox 
connection. Dees OOF 
|- 
ER hion carrectn 
Enter a name and choore an icon for the connection: 
Deconnected ARO detect Ako detect nm T 
4 |Select the proper COM port. tT 


Bo 


Enter details for the phone number that you want to dial: 


Country/region: De 


Area code: 


Phone number: 


Connect using: x 
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Description 
Configure as shown to the right. 
Press OK. 


COMI Properties 


General | Port Settings | Driver | Details 


Comment or picture 


Baud Rate: z 
Data bits: fe  » 
Party: [None (tsti(‘i«é‘ SY 
Stop bits: fi x 


Flow control: | None v 


Open Properties in the File menu. 
Selects Settings tab. 
Press ASCII Setup. 


DIS Properties 


PP 
| Connect To| Settings | 


©) Ctri+H 


E mulation: 


Function, arrow, and ctrl keys act as 
©) Terminal keys 


Backspace key sends 


(ok } [_cancet_] 


© Windows keys 


© Del © Ctri+H, Space, Ctrl+H 


| Auto detect 


Telnet terminal ID: 


Backscroll buffer lines: 


[C] Play sound when connecting or disconnecting 


Input Translation... 


ASCII Setup... 
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in the Installation Manual. 


# | Description Comment or picture 
7 eas setup as shown to the right on ASCII Setup 
ASCII Sending 
Send line ends with line feeds 
Echo typed characters locally 
Line delay: | 0 milliseconds. 
Character delay: | 0 milliseconds. 
ASCII Receiving 
Append line feeds to incoming line ends 
[C] Force incoming data to 7-bit ASCII 
Wrap lines that exceed terminal width 
8 | Check that communication is working 
between the two PCs. If this is not the case, 
one of the settings is incorrect or the cable is 
defective. 
9 |When the communication is working close 
the HyperTerminal program on the PC with 
the ECA installation. 
10 | Configure the ECA application as explained R Ses) 


ee bore Configure comi ~- 
Database Connection 
oiam COM bors © MS SQL Express MS SQL Server 
About Name of computer where the database is installed: main 
Default database instance name: swe000 
Default database name SW60001 
Default database timeout 30 
Database User: SW6K11 
Database User Password: HmAeC2005 
COM Port 


Baud Rate: 
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# | Description Comment or picture 
11 | Make a shortcut to the ECA, select properties External Control Application COM1 Properties (?] 
and set the command line parameters as = 
shown if you are using COM1. If not type in General| Shortcut | Compatibility | Security, 
the COM port in use. f 
FC A External Control Application COM1 
The -W parameter brings up a window. 
Target type: Application 
Remember to make a space between the Target location: External Control Application 
two commands. Target: 
Start in: "C:\Program Files\DIS ‘External Control Applicatio 
Shortcut key: § None 
Run: | Normal window w 
Comment: 
12 | Start the ECA application using the short cut. | EETIETITET — ax 


Messages from CUI toE CA 


03:10.14 !s137:E1 [331115149151 [55)[58][69][1 3 
03:10.14 Ir136:C1 [33][11 4][49][51 [54]58][67 11 3) 
03:10.14 IDI [33][68][1 3) 
03:10.24 1K1:7C1 [33][75][49][58][55][67 [1 3) 
03:10.24 1010:B2) [33][81][49][48][58][66][50][1 3 
03:10.24 IEMANU: 761 [33][69][77][65][78][85][58)[55]54][1 3] 
03:10.24 !s137:E1 [33][115][49][51 [55 ][58][69][1 3 
03:10.24 !r136:C1 [33][11 4][49][51 [54 ]58][67 [1 3) 
03:10.24 !D1 [33][68][1 3] 
03:11.17 registeredSuccess [114][101J[103)[105)[115)[116][101 
03:13.17 registeredSuccess [114][101)[103)[105)[115][116][101 
03:15.17 registeredSuccess [114][101][103)[105][115)[116][101 
03:17.17 registeredSuccess [114][101)[103)[105)[115)[116)[101 


03:19.17 registeredSuccess [114)[101 )[103][105)[115)[116)[101 
03:21.17 registeredSuccess [114][101)[103)[105)[115)[116][101 


03:23.17 registeredSuccess [114] 
03:25.17 registeredSuccess [114 
03:27.17 registeredSuccess [114] 
03:29.17 registeredSuccess [114] 
03:31.17 registeredSuccess [114] 
03:33.17 registeredSuccess [114] 

3:35.17 registeredSuccess [114] 


Messages fromAMX to E CA 


03:01.17 EcaHeartBeat 
03:03.17 EcaHeartBeat 
03:05.17 EcaHeartBeat 
03:07.17 EcaHeartBeat 
03:09.17 EcaHeartBeat 
03:10.14 ?D1 [63][68][1 3} 
03:10.24 ?D1 [63][68)[1 3] 
03:11.17 EcaHeartBeat [69] 
03:11.43 !S134:EBI [33][83} 
03:12.07 10134:E71 [33][79] 
03:13.17 EcaHeartBeat [69] 
03:15.17 EcaHeartBeat [69] 
03:17.17 EcaHeartBeat [69] 
03:19.17 EcaHeartBeat [69] 
03:21.17 EcaHeartBeat [69] 
03:23.17 EcaHeartBeat [69] 
03:25.17 EcaHeartBeat [69] 
03:27.17 EcaHeartBeat [69] 
03:29.17 EcaHeartBeat [69] 
03:31.17 EcaHeartBeat 
03:33.17 EcaHeartBeat [69] 
03:35.17 


10511151116]1101 
1051111511161101 
10511151[116]101 
1051111511161101 
'105][115][1 16][101 
105111151116101 
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13 


Description 


Check that you receive messages in the 
terminal window and check that you can 
send messages. 


Comment or picture 


ECA - HyperTerminal 
Ele cd yew Cal Transfer teb 
D $06 gS 


t0134 :E7 


ARo detect 
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